package com.jzo2o.foundations.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.jzo2o.api.foundations.dto.response.ServeAggregationResDTO;
import com.jzo2o.common.model.PageResult;
import com.jzo2o.foundations.model.domain.Serve;
import com.jzo2o.foundations.model.dto.request.ServePageQueryReqDTO;
import com.jzo2o.foundations.model.dto.request.ServeUpsertReqDTO;
import com.jzo2o.foundations.model.dto.response.*;

import java.io.IOException;
import java.util.List;

/**
 * 区域服务管理
 *
 * @author itcast
 * @create 2023/7/17 16:49
 **/
public interface IServeService extends IService<Serve> {

    /**
     * 区域服务分页
     *
     * @param servePageQueryReqDTO
     * @return
     */
    PageResult<ServeResDTO> findByPage(ServePageQueryReqDTO servePageQueryReqDTO);

    /**
     * 区域服务新增
     *
     * @param serveUpsertReqDTO
     */
    void add(List<ServeUpsertReqDTO> serveUpsertReqDTO);

    /**
     * 区域服务删除
     *
     * @param id
     */
    void deleteById(Long id);

    /**
     * 区域服务上架
     *
     * @param id
     */
    void onSale(Long id);

    /**
     * 区域服务下架
     *
     * @param id
     */
    void offSale(Long id);

    /**
     * 获取首页服务列表数据
     *
     * @param regionId 地区ID，用于筛选对应区域的服务信息
     * @return 返回首页服务列表数据，包含服务分类信息的数据传输对象集合
     */
    List<ServeCategoryResDTO> firstPageServeList(Long regionId);

    /**
     * 获取热门服务列表
     *
     * @param regionId 区域ID，用于查询指定区域内的热门服务
     * @return 返回热门服务列表，列表中的每个元素都是ServeAggregationSimpleResDTO类型
     */
    List<ServeAggregationSimpleResDTO> hotServeList(Long regionId);

    /**
     * 根据ID查询服务聚合简单结果DTO
     *
     * @param id 查询条件的唯一标识符
     * @return 返回服务聚合简单结果DTO对象，包含查询到的相关信息
     */
    ServeAggregationSimpleResDTO findById(Long id);

    /**
     * 根据地区ID获取服务类型聚合列表
     *
     * @param regionId 地区ID，用于筛选特定区域的服务类型
     * @return 返回服务类型聚合简化响应DTO列表，包含服务类型的基本信息
     */
    List<ServeAggregationTypeSimpleResDTO> serveTypeList(Long regionId);

    /**
     * 根据城市编码、关键词和服务类型ID搜索服务信息
     *
     * @param cityCode    城市编码，用于限定搜索的城市范围
     * @param keyword     搜索关键词，用于匹配服务名称或描述等信息
     * @param serveTypeId 服务类型ID，用于筛选特定类型的服务
     * @return 返回符合条件的服务列表，每个服务以ServeSimpleResDTO对象形式返回
     */
    List<ServeSimpleResDTO> search(String cityCode, String keyword, Long serveTypeId) throws IOException;

    /**
     * 根据ID查询服务详情
     *
     * @param id 服务id
     * @return 服务详情
     */
    ServeAggregationResDTO findServeDetailById(Long id);
}
